═══ 1. ZiPMe ═══ ZiPMe is a 32-Bit multi-threaded PM program. It helps you manage ZIP archives of the Info-ZIP versions Zip 2.0 and UnZip 5.1. Newer Info-Zip versions will be usable if there is no change in the command-line arguments. After the correct installation of ZiPMe, you can open an archive with Open in the File menu or with drag & drop of the archive onto the container of the ZiPMe window. The contents of the archive are then put into the Container, and on the status line you can see the zipfile size, the number of files in the archive, and the number of bytes in each file. You can perform the following actions with ZiPMe: ■ add files to archives ■ extract files from archives ■ delete files from archives ■ view files in archives ■ edit the archive comment You can get help for each menu or dialog just by clicking on help or pressing F1. ═══ 2. Installation ═══ After extracting the ZiPMe archive into a directory, drag a program object from OS/2's Templates folder to the desired location on the Desktop. Open the program object's Settings notebook, and on the first page enter ZiPMe's path and file name, for example C:\ZIPME\ZIPME.EXE. Now, on the same page, enter the path leading to ZiPMe in the Working directory entry field. (In the example above it is C:\ZIPME.) If you want to keep ZiPMe's ini file in a different directory, you can enter the parameter -i with the name of an existing directory in the Parameters field. If you do that, ZiPMe will place its ini file in the directory you specified, for example: -i D:\MyInis. On the last page of the Settings notebook you can change the title to ZiPMe. Then copy the files zip.exe and unzip.exe into the directory where ZiPMe is, or if you want to keep those files in another directory, you must add this directory to the PATH statement of your CONFIG.SYS. You must reboot for this change to take effect. ═══ 3. Container ═══ The container is the main part of ZiPMe, all files stored in an archive are shown in it. These files can be shown by the container in different views. The container's behavior is nearly the same as that of a WPS folder. You can customize the container in ZiPMe's Settings notebook, which you access by choosing the File item on the menu bar, and then the Settings item from the pulldown menu. The container gives you the ability to sort files and to select files interactively. You can select files with the keyboard or the mouse. Selecting with mouse To select files, click on the first one with the left mouse button and then move the mouse pointer over all files you want to select, while holding down the mouse button. Another way is to click on every file you want to select while holding down the Ctrl key. In Details View, you can select groups of files by selecting the first file and then clicking on the last one while holding the Shift key. Selecting with keyboard Move to the file you want to select with the cursor keys, and then select or deselect it with the space bar. If you want to select more than one file, press Shift+F8 first. Then select the desired files with the cursor keys and space bar, and press Shift+F8 again. In Details View you can select groups of files with the cursor keys while holding down the Shift key. ═══ 4. Multi-threading ═══ Multi-threading means, that there is more than one process active at the same time in one task. This has the advantage that the user doesn't have to wait if a process is active. While ZiPMe is adding, extracting or deleting files in an archive, the user can load another archive and can add, extract, delete or view files there. ═══ 5. Font Selection ═══ The font of the status line, the list boxes and the text windows in the ZiPMe window and in the windows View and Edit Comment can be changed with the Font Palette of the WPS. Open the Font Palette in the System Setup folder. Select the new font and drag it to the status line, container or text window. You can use a different font in each of these places if you like. You can save the changes by selecting Save in the Save Settings dialog in the File menu. ═══ 6. Drag & Drop ═══ Drag & drop is an easy way to open archives, add files to archives and extract files from archives. You can open an archive simply by selecting it in the Drives object and dragging it, with the right mouse button held down, onto ZiPMe's list box. There you drop it by releasing the right mouse button. Only a single file is accepted, and it must end with ".zip". To add files to an archive you select them in the Drives object and drag them as described above, but this time you hold down the Ctrl key while dragging the files onto the container. If you selected the Show Add Dialog option in the Save Settings dialog, the Add dialog appears, with all dropped files showing in the entry field. If there is no archive open at this time, first the New dialog will appear, and you have to create a new archive. To extract files from an archive, you mark them in the container of the ZiPMe window. Then, while holding down the Ctrl key you drag them onto a folder of a Drives object. If you selected the Show Extract Dialog option in the Save Settings dialog, the Extract dialog appears with the selected Target Path in the entry field. ═══ 7. File Menu ═══ The File Menu contents: New Here you can type in the name of the new archive. Open Here you can open an existing archive. Close Here you can close the current archive. Delete Here you can delete the current archive. Settings Here you can config ZiPMe and save this configuration in the file zipme.ini. ═══ 8. New ═══ In this dialog you can create a new archive. To do this you type the name of the new archive in the entry field. If the new archive should be placed in a directory other than the current one, you can type in the complete path with drive and directory. If the new filename exists, you are asked if you want to overwrite the old one. If you agree, the old file is deleted immediately. If the given path doesn't exist, you are asked if it should be created. ═══ 9. Open ═══ In this dialog you select the archive you want to use. Open filename The search pattern of the files in the files list box is placed here. If you select a file the complete filename is placed in this field. You can also type in the name of the file you want to open. Type of file Here you can select the type of the files which are shown in the files list box. This function isn't used yet. Drive Here you can select the drive from which you want to get the file. File Here you can select the file you want to open. If this list box is active, you can type in the first letter of the file you want to open. The cursor then comes to rest on the first file having this letter as its first letter. Directory Here you can select the directory containing the file that you want to open. ═══ 10. Close ═══ If you select Close, the current archive is closed. The name of the archive disappears from the title of the window and the list box becomes empty. You have to open another archive or make a new one to go on. ═══ 11. Delete Archive ═══ If you select Delete, you are asked if you are sure that you want to delete the current archive. If you press the Yes button, ZiPMe deletes the current archive. After that the list box becomes empty and the name of the current archive, that doesn't exist any more, disappears from the title bar of the ZiPMe window. ═══ 12. Settings ═══ Here you get a dialog with a notebook in it. On several pages of the notebook you can configure ZiPMe as you want it to behave. If you press the Save button, your current configuration is written to the file zipme.ini. If you delete this file, ZiPMe will start next time with its standard settings. Setup On this page you can set the Default Load Path and the Default Add Path, and you can choose from which windows the settings should be saved. The Default Load Path says which directory is shown when you select Open from the File menu. If you have opened an archive from another directory before, this last-used directory is shown. You can avoid this if you select Close If you don't enter a path here, the Default Load Path will be set to the directory where you have placed ZiPMe. The Default Add Path says which directory is shown when you press the Select Files button from the Add If you already have chosen files from other directories with this dialog, the last-used directory will be shown this time. If you don't enter a path here, the Default Add Directory will be set to the directory where you have placed ZIPME. In Save Window Status you can choose from which windows the position, size and font should be saved. You can only choose windows which are open at this time. For example, to save the position of the Comment Window you open it, move it to the position where you want to have it as default, size it and choose the right fonts. After that you select Save Settings, mark Comment Window and press Save. Container Here you can choose a Standard View and a Standard Sorting type for the container; from then on, the view and sorting type you've chosen will be used whenever you start ZiPMe. You can also choose whether ZiPMe should show an icon for each file in Details View and the size in pixels these icons should be. If you set the size to 0, the normal system size of the icons is used. Add Choose your favourite settings for the Add dialog. Extract Choose your favourite settings for the Extract dialog. Drag & Drop Choose here which dialog should be shown if you add or extract files to or from an archive with drag & drop. If a dialog is shown, you can change the parameters for this dialog. If a dialog is not shown, ZiPMe uses your default settings for this dialog and starts to add or extract. ═══ 13. Edit Menu ═══ The Edit Menu contents: Add Here you select the files which you want to add to the current archive. Extract Here you select which files should be extracted from the current archive. Delete Here you can delete the marked files of the current archive. View Here you can view the marked files of the current archive. Edit Comment Here you can edit the comment of the current archive. ═══ 14. Add ═══ In this dialog you select the files you want to add to the current archive and you select how they are added. This action is only active if an archive has been opened or created. While the files are being added you can go on working with the archive or you can open or create another one. Files Here you can type in the files and their paths which should be added to the archive. You can use wildcards as for example *.exe or os2??.dll. There must be at least one blank between filenames. The Add button is only active if there is at least one file typed in. File Selection If you press this button, the same Dialog Box as in Open appears. Here you can comfortably select several files from several directories. The only difference from the Open Dialog is that here you can select more than one file at once in a single directory. The selected files are put in the field Files. This field is 5000 characters long, and if your list is longer an error message appears saying the list already contains as many files as it can hold. Action Here you select how files are added to the archive. If you select All, then all selected files are added. If the file already exists in the archive, it is overwritten. If you select Changed, only files are added which are already in the archive and have been changed. If you select Changed or new, all selected files are added which are not already in the archive or which have been changed. If you select Delete original after adding, the original file is deleted after it has been added into the archive. If you select simulate PKZIP made zipfiles, the files are compressed in a format allowing them to be read and extracted by PKZip and PKUnzip. Directories If you select Add directories the files and subdirectories of the given directory are added to the archive, too. For example if you type in \os2\*, \os2\dll\* is added, too. If you select Don't add pathnames, the files are added without the directories from which they have been added. End-of-line conversion Here you can decide if the files to add get an end-of-line conversion. This is useful, for example, for text files, which will be extracted on a Unix system. In this case you can change the MSDOS and OS/2 typical end-of-line marker CR LF to the typical Unix end-of-line marker LF by selecting CR LF -> LF. If you select LF -> CR LF the conversion works in the other direction. Compression Here you can use the slider to select the degree of compression. A lower value means a small compression and a short processing time; a higher value means better compression but it takes its time. ═══ 15. Extract ═══ In this dialog you select which files of the current archive you want to extract and where they should be extracted to. This action is only active if an archive has been opened or a new one has been created and if there is at least one file in it. While the files are being extracted you can go on working with the archive or you can open or create another one. Target In the entry field To you can type in the complete path with drive and directory where you want to extract the files to. If the directories don't exist, they are created. Don't forget that the directories in the archive are created, too, if you don't select Don't use Pathnames. If you leave the entry field empty the files are extracted to the current work directory of ZiPMe. If you select Create directory with name of archive, a directory with the name of the archive is created in the directory that has been typed into the entry field and the files are extracted into it. If the entry field is empty the directory is created in the actual work directory of ZiPMe. Files Here you select which files are extracted. If you select All, then all files in the archive are extracted. Marked is only active if you have marked files in the list box. If you select Marked, only the marked files are extracted. If you select Files you can type in files or wildcards such as *.exe or os2??.dll which are then extracted. You have to put at least one blank between the filenames or wildcards. If you select Changed or Changed or new, the only files extracted are those which are new in the given directory or which have been changed. Overwrite Here you can select with Always or Never to determine whether existing files can be overwritten or not. If you select Never it is nonsense to select Changed because the changed files can't be overwritten. ═══ 16. Delete ═══ Here you can delete all marked files in the current archive. Before the files are deleted, you are asked, if you are really sure that you want to delete them. This action is only active if an archive has been opened or a new one has been created, and if there is at least one file marked. While the files are being deleted you can go on working with the archive. ═══ 17. View ═══ If you select this menu item, a window is opened with a text window and a list box in it. In the list box are the names of the files marked in the list box of the ZiPMe window when you selected this menu item. In the text window the contents of the first file in the list box are shown. If you select another file name in the list box, you can see the contents of that file in the text window. In the text window you can mark text with the mouse or the cursor keys and copy it into the clipboard by pressing the Clipboard button. You can open two of these View windows at the same time so that you can compare two files. Because you can open another archive after opening a View window, you can even compare two files from different archives. The positions and sizes of the windows and the fonts of the text windows and list boxes can be saved in the Save Settings dialog. ═══ 18. Edit Comment ═══ You can link a comment to each zip file. This comment is then always shown on the command line when anyone extracts or views an archive there. If you select this menu item, you can view and edit the archive's comment. With the menu items Cut, Copy and Paste of the Edit menu you can cut or copy marked text to the clipboard or paste text from the clipboard. You can use OS/2's default keys such as Ctrl-Ins for copy, and so on, too. If you select Save from the Comment menu, the new comment is saved in the archive. If you open another archive while editing the comments of the archive opened before, the comment will be saved to the archive opened before, which is shown in the title bar of the Edit Comment window. ═══ 19. Options Menu ═══ The Options Menu contents: Mark Here you can mark or unmark files of the current archive Container View Here you can select different container views. Sort Here you can select the sort type of the container. ═══ 20. Mark Menu ═══ The Mark Menu contents: Mark all Here you can mark all files in the archive. Mark choice Here you can mark all files with the given string in their container entry. Unmark all Here you can unmark all marked files in the archive. Unmark choice Here you can unmark all marked files with the given string in their container entry. ═══ 21. Mark all ═══ Here you can mark all files in the archive. This action is only active if an archive has been opened or a new one has been created and if there is at least one file in it. ═══ 22. Mark choice ═══ In this dialog you can type in a string. If you press OK, all files with this string in their name are marked. If you check the check box "case sensitive search", the search of the string is case sensitive. If this check box is not checked, for example even "MyText" is marked, if you type in "mytext". This Action is only active if an archive has been opened or a new one has been created with at least one file in it. ═══ 23. Unmark all ═══ Here you can unmark all marked files in the archive. This action is only active if an archive has been opened or a new one has been created and if there is at least one file in it. ═══ 24. Unmark choice ═══ In this dialog you can type in a string. If you press OK, all files with this string in their name are unmarked. If you check the check box "case sensitive search", the search of the string is case sensitive. If this check box is not checked, for example even "MyText" is unmarked, if you type in "mytext". This Action is only active if an archive has been opened or a new one has been created with at least one file in it. ═══ 25. Container View ═══ You can select one of the following container views by selecting its corresponding menu item. The option you choose will be indicated by a check mark in front of its menu item. Details View In this view the files of the current archive are shown in list form, with entries for Icon, Name, Date, Time, Length, compression Ratio and Size. Icon View In this view the files of the current archive are shown as icons, with the names of the files located under the icon. Name View In this view the files of the current archive are shown as icons, with the names of the files located to the right of their icons. The files are arranged in an orderly fashion. Text View In this view, only the file names of the files of the current archive are shown. ═══ 26. Sort ═══ You can select one of the following sort types by selecting its corresponding menu item. The option you choose will be indicated by a check mark in front of its menu item. None The files of the current archive are shown as they are actually placed in the archive. Name The files of the current archive are sorted by their file names. Length The files of the current archive are sorted by their file lengths. Date / Time The files of the current archive are sorted by their dates; if their dates are the same, they are sorted by their times. ═══ 27. Help Menu ═══ The Help Menu contents: Help index Shows a list of the help topics. General Help Shows the main help for ZiPMe. Keys Help Shows how the keys are set in ZiPMe. Using Help Shows how to use the help facility. Product information Shows the ZiPMe icon and information about the author. ═══ 28. Help index ═══ Here you get a list of all help topics for ZiPMe. They are listed in alphabetical order; you can get the help text you want by clicking twice on the topic. ═══ 29. General Help ═══ General Help shows you summary information about ZiPMe. Here you can see what you can do with the program and how you can do it. There are also links to other topics. ═══ 30. Keys Help ═══ Here you can see how the function keys are assigned in ZiPMe. They are "hot keys" for functions you need often and where it is faster to press a key than to go through the menus. If you are experienced with ZiPMe you can work faster by just using these keys. ═══ 31. Using Help ═══ Here you get a help text from the operating system explaining how to use the help facility itself. Here you can see how to get help about a special topic, and how to search for special expressions, and so on. This help comes from OS/2, not from ZiPMe. ═══ 32. Product information ═══ Here you get information about ZiPMe. The icon, the current version number and the address of the author are shown. You should send questions, information about any errors found, and wishes for the next version of ZiPMe to this address. ═══ 33. Button Bar ═══ Here you see which buttons of the button bar are equivalent to which menu items The same as menu item New. The same as menu item Open. The same as menu item Close. The same as menu item Add. The same as menu item Extract. The same as menu item Delete. The same as menu item View. The same as menu item Edit Comment. The same as menu item Mark all. The same as menu item Mark choice. The same as menu item Unmark all. The same as menu item Unmark choice. ═══ 34. Function keys in ZiPMe ═══ ZiPMe assigns the following functions to the function keys: F1 Context sensitive help for the current menu or dialog. F2 The same as menu item Close. F3 The same as menu item Open. F4 The same as menu item New. F5 The same as menu item Add. F6 The same as menu item Extract. F7 The same as menu item Delete. F8 The same as menu item View. Alt-F4 Ends the Program. Alt-F5 This makes the normal ZiPMe window from the minimized icon. It is only active if the window has been minimized. Alt-F7 After pressing these buttons you can change the position of the ZiPMe window with the cursor keys or the mouse, and fix it by pressing ENTER or the left mouse button. Alt-F8 After pressing these buttons you can change the size of the ZiPMe window with the cursor keys or the mouse, and fix it by pressing ENTER or the left mouse button. Alt-F9 Here you minimize the ZiPMe window to its icon. You find it in the folder Minimized Window Viewer. Alt-F10 Here you make the ZiPMe window as big as your screen. Cntl-Esc Here you call up OS/2 Window List. In this list you can change from ZiPMe to another program.